home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr49 / ngwmfc.zip / README.MFC < prev    next >
Text File  |  1995-01-10  |  21KB  |  612 lines
  1.          THE GROUPWISE MESSAGE FILE CONVERSION NLM
  2.  
  3. The GroupWise Message File Conversion NLM (referred to as MFC
  4. NLM; its file name is NGWMFC.NLM) overcomes the file format
  5. differences that exist between WordPerfect Office 3.1 and Novell
  6. GroupWise 4.x systems. This NLM also provides the following
  7. benefits:
  8.  
  9.     ■ Increases the speed of message conversion
  10.     ■ Lets you use the GroupWise NLM and OS/2 Message Servers
  11.     ■ Provides seamless two-way message conversion
  12.  
  13.  
  14.  
  15. PREREQUISITES
  16.  
  17. Before you install the MFC NLM you must have already
  18. interconnected the WordPerfect Office 3.1 and Novell GroupWise
  19. 4.x systems.  For detailed instructions about interconnecting the
  20. two systems, see:
  21.  
  22.     Connecting GroupWise 4.1 and WP Office 3.1 Systems in the
  23.     GroupWise Administration Guide.
  24.  
  25. You must also be able to run the WP Office 3.1 Admin program.
  26.  
  27. The following NetWare NLMs must be loaded prior to loading the
  28. MFC NLM:
  29.  
  30.     CLIB
  31.     STREAMS
  32.     NGWLIB
  33.     NGWMSIP
  34.     AFTER311
  35.     SNMP
  36.     TLI
  37.  
  38. You do not have to reload these NLMs if they are already loaded.
  39. Use NetWare's MODULES console command to see which NLMS are
  40. already loaded. You may want to load these NLMs from
  41. AUTOEXEC.NCF.
  42.  
  43.  
  44.  
  45. INSTALLING THE MFC NLM
  46.  
  47. You must perform the following tasks to install the MFC NLM:
  48.  
  49.     ■ Create the directory structure in the 4.x domain directory
  50.     ■ Copy the NLMS to SYS:SYSTEM
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66. CREATING THE DIRECTORY STRUCTURE
  67.     The director y structure the MFC NLM uses to route messages must reside 
  68.     in the 4.x domain structure. When you installed GroupWise, the \WPGATE
  69.     directory was added as part f the domain file structure. This directory
  70.     is reserved for  GroupWise Gateways. The GroupWise Admin program treats
  71.     the MFC NLM as a gateway. For this reason you must use the DOS MD
  72.     command to append the following subdirectories to the \WPGATE directory:
  73.  
  74.     \WPGATE
  75.       \MFCGW
  76.          \LOG
  77.          \PROBLEM
  78.            \LIN
  79.            \MF
  80.          \TEMP
  81.            \LIN_MF
  82.            \MF_LIN
  83.          \TRANSIN
  84.  
  85.  
  86. COPYING THE MFC NLM TO SYS:SYSTEM
  87.     NetWare must first know where the NLM resides. By default, NetWare looks
  88.     to the SYS:SYSTEM directory for all NLMs. For this reason, copy the
  89.     following files to the SYS:SYSTEM directory on the server where the NLMs
  90.     will be loaded.
  91.  
  92.     NGWMFC.NLM
  93.     STARTUP.MFC
  94.  
  95.     If you choose not to copy the files to SYS:SYSTEM, you must either 
  96.     include the pathname where the MFC NLM is located in the search path,
  97.     or type full pathname when loading the NLM.
  98.  
  99.     After you created the directory structure and copied the NLM to the
  100.     SYS:SYSTEM directory, you must configure the GroupWise 4.x system 
  101.     and the WP Office 3.1 system. Proceed to the next section for more
  102.     information.
  103.  
  104.  
  105.  
  106. CONFIGURING THE GROUPWISE 4.X SYSTEM
  107.  
  108. To configure the MFC NLM you must use the Admin program to:
  109.  
  110.     ■ Define the NLM as a gateway
  111.     ■ Alter the GroupWise 4.x link to the WP Office 3.1 system
  112.     ■ Alter the WP Office 3.1 link to the GroupWise 4.x system
  113.  
  114. To define the MFC NLM as a gateway,
  115.  
  116. 1   Start the Admin program.
  117.  
  118. 2   Choose the domain the MFC NLM will service. This is the domain where 
  119.     you created the MFC subdirectories.
  120.  
  121. 3   Choose CREATE from the File menu, then choose GATEWAY to  display 
  122.     the Gateway Information dialog box.
  123.  
  124. 4   Fill in the fields:
  125.  
  126.       GROUPWISE NAME (required):  Enter a name you will use to identify 
  127.       the MFC NLM.
  128.  
  129.       FOREIGN NAME:  This field is not used by the MFC NLM.
  130.  
  131.       DESCRIPTION:  (Optional): Enter descriptive information, such as
  132.       the date the NLM was installed, who installed it, the connecting 
  133.       WP Office 3.1 Transfer Host, or any other pertinent information.
  134.  
  135.       DIRECTORY:  Choose this field to display the Installed from this
  136.       list.
  137.  
  138.       GATEWAY ALIAS TYPE:  This field is not used by the MFC NLM.
  139.  
  140.       EXECUTION MODE:  Choose STAND-ALONE.
  141.  
  142.       TIME ZONE:  Choose this option to set the time zone for the MFC NLM.
  143.  
  144.       ADMINISTRATOR:  The options in this menu do not apply to the MFC NLM.
  145.  
  146.       TIME:  The options in this menu do not apply to the MFC NLM.
  147.  
  148.       OPTIONAL:  Choose this option to display the Optional only ones that 
  149.       apply to the MFC NLM:
  150.  
  151.          LOGGING LEVEL: Use this field to control the amount of information
  152.          displayed on the MFC NLM Operation screen. This field sets the 
  153.          default for the NLM; however, the logging level can be altered 
  154.          using the /loglevel startup switch or the Logging Level option 
  155.          in the MFC NLM interface. The logging levels are:
  156.  
  157.          ■ OFF:  This option disables the logging feature.
  158.  
  159.          ■ NORMAL (Default): This option provides general informational
  160.            messages.
  161.  
  162.          ■ DIAGNOSTIC: This option provides more detail than the Normal level.
  163.  
  164.          ■ VERBOSE: This option logs all NLM activity but also requires more 
  165.            network resources.
  166.  
  167.          MAX LOG AGE:  This option lets you set how many days the log files 
  168.          are stored until they are automatically deleted. The default is 
  169.          7 days.
  170.  
  171.          LIMIT DISK USE:  This option sets the total amount of disk space 
  172.          log files can occupy. The default is 1024K or 1M.
  173.  
  174. 5   Press OK at the Optional Gateway Settings dialog box to return to the 
  175.     Gateway Information dialog box.
  176.  
  177. 6   Press OK at the Gateway Information dialog box to return to the System 
  178.     window.
  179.  
  180. You are now ready to proceed to the next section for information about how 
  181. to alter the links between the WP Office 3.1 and GroupWise 4.x systems.
  182.  
  183.  
  184.  
  185. ALTERING THE GROUPWISE 4.X LINK
  186.  
  187.     To alter the GroupWise 4.x link,
  188.  
  189.     1 From the System Window, choose the domain where the MFC NLM resides.
  190.  
  191.     2 Choose EDIT from the Actions menu to display the Domain Information 
  192.       screen.
  193.  
  194.     3 Choose MESSAGE SERVER CONFIGURATION to display the Message Server 
  195.       Configuration dialog box.
  196.  
  197.     4 Choose NETWORK LINKS to display the Network Links dialog box.
  198.  
  199.     5 Choose the WP Office 3.1 domain from the list, then choose  EDIT LINK 
  200.       to display the Define Domain Connection dialog box.
  201.  
  202.     6 Choose GATEWAY as the link type to display the Gateway Link dialog box.
  203.  
  204.     7 Fill in the fields:
  205.  
  206.       LOCAL GATEWAY: If the MFC NLM is the only gateway, it will
  207.       automatically appear in the field. If not, choose this  field to
  208.       display the gateway list, then choose the MFC NLM.
  209.  
  210.       GATEWAY ACCESS STRING: This field does not apply to the MFC NLM.
  211.  
  212.       RETURN LINK: Enter the name of the WP Office 3.1 Transfer Host that 
  213.       links to the GroupWise 4.x system.
  214.  
  215.     8 Choose OK to return to the Network Links dialog box.
  216.  
  217.     9 Choose CLOSE to return to the Message Server Configuration dialog box.
  218.  
  219.     10 Choose OK to return to the Domain Information dialog box.
  220.  
  221.     11 Choose OK to return to the System Window.
  222.  
  223.  
  224.  
  225. ALTERING THE WP OFFICE 3.1 LINK TO THE GROUPWISE 4.X SYSTEM
  226.     Before WP Office 3.1 messages can be converted, you must  alter the 
  227.     Transfer Host's link to the GroupWise 4.x system.
  228.  
  229.     To alter the WP Office 3.1 link,
  230.  
  231.     1  Change to the WP Office 3.1 Administration directory.
  232.  
  233.     2  Type OFFADMIN and press Enter to display the Office System
  234.        Administration menu.
  235.  
  236.     3  Choose Using Office Notebook (N) to display the Office 
  237.        System Admin (Notebook) menu.
  238.  
  239.     4  Choose Host Notebook (H), then enter the name of the path to 
  240.        the HOSTID.NB file when prompted. The list of all your  
  241.        WP Office 3.1 hosts is displayed.
  242.  
  243.     5  Select the Transfer host you use to connect to the GroupWise 4.x 
  244.        system, then choose Edit to display the WordPerfect Office Host screen.
  245.  
  246.     6  Tab down to the HOST DIRECTORY field. The path in this field should 
  247.        be pointing to the domain directory of the GroupWise 4.x system.
  248.  
  249.     7  Alter the path to point to the \WPGATE\MFCGW directory you created 
  250.        earlier.
  251.  
  252.     8  Save the changes and return to the Office System Admin (Notebook)
  253.        screen.
  254.  
  255.     9  Run GENOFF from the Office System Admin (Notebook) screen to update
  256.        the databases for each host.
  257.  
  258.     10 Exit the Admin Program.
  259.  
  260.  
  261.  
  262.     At this point the MFC NLM is linked to the WP Office 3.1 and  
  263.     GroupWise 4.x systems. Proceed to the next section for instructions 
  264.     about loading the MFC NLM.
  265.  
  266.  
  267.  
  268. LOADING THE MFC NLM
  269.  
  270. You can load the MFC NLM:
  271.  
  272.     ■  Manually at the NetWare console
  273.     ■  Manually at the NetWare console using a startup file
  274.     ■  Automatically through AUTOEXEC.NCF
  275.  
  276. Regardless of how you choose to load the NLMs, you must first be familiar
  277. with the NLM's startup switches.
  278.  
  279.  
  280.  
  281. STARTUP SWITCHES
  282.  
  283. The MFC NLM uses a series of startup switches to provide the NLM with 
  284. vital information. Some of the switches are required; others are optional.
  285. The list below defines each startup switch.
  286.  
  287.     @
  288.     Use this switch to point to a startup file for loading the MFC NLM.
  289.     Do not add a space between the @ pointer and the startup file name.
  290.  
  291.     Syntax: load ngwmfc @[server/volume:]filename
  292.     Sample: load ngwmfc @server1/vol1:startup.mfc
  293.  
  294.     
  295.     /home (Required)
  296.     Use this switch to point the MFC NLM to the location of the \WPGATE\MFC 
  297.     directory. This directory should be a subdirectory of the GroupWise 4.x 
  298.     domain directory structure. If the GroupWise 4.x domain resides on a 
  299.     different file server, you must include the file server and volume name 
  300.     in the syntax. You must also use the \USER and \PASSWORD switches.
  301.  
  302.        Syntax: /home-[server/volume:]path
  303.        Sample: /home-server1/vol1:headq\wpgate\mfcgw
  304.  
  305.     /31transin (Required)
  306.      Use this switch to point to the location of the WP Office 3.1 primary host's
  307.      transin directory. 
  308.  
  309.      If the WP Office 3.1 system resides on a different file server, you 
  310.      must include the file server and volume name in the syntax. You must 
  311.      also use the \USER and \PASSWORD switches.
  312.  
  313.        Syntax:  /31transin-[server/volume:]path 
  314.        Sample:  /31transin-server1/vol1:office30\transin
  315.  
  316.     /logpath
  317.     Use this switch to point to the location where the log files are stored.
  318.     If the log files are stored on a different server, you must include the 
  319.     server and volume names. The directory \wpgate\mfcgw\log is the default.
  320.  
  321.        Syntax: /logpath-[server/volume:]path
  322.        Sample: /logpath-server1/vol1:log
  323.  
  324.     /31pull
  325.     Use this switch when you are connecting to a VAX system. The VAX cannot
  326.     place messages in the MFC NLM's directory structure. Instead, the 
  327.     Message Server must pull the messages from the VAX. Enter the location 
  328.     of the VAX pull directory.
  329.  
  330.        Syntax:/31pull-[server/volume:]path
  331.        Sample:/31pull-server1/vol1:\31domain\to_pc\transin
  332.  
  333.     /scancycle
  334.     Use this switch to set the number of seconds the NLM scans its 
  335.     directories to convert messages. The default is 60 seconds.
  336.  
  337.        Syntax: /scancycle-[seconds]
  338.        Sample: /scancycle-300 (5 minutes)
  339.  
  340.     /logdiskoff
  341.     Use this switch to turn off disk logging. The default is On.
  342.  
  343.        Sample: /logdiskoff
  344.  
  345.     /loglevel
  346.     Use this switch to control the level of logging information the NLM 
  347.     displays. The options are Diagnostic, Verbose, Normal, and Off. The 
  348.     default is Normal.
  349.  
  350.        Syntax: /loglevel-[level]
  351.        Sample: /loglevel-diagnostic
  352.  
  353.     /logdays
  354.     Use this switch to designate how many days to keep log files on disk. 
  355.     The files are deleted if they exceed this number of days. 
  356.     The default is 7 days.
  357.  
  358.        Syntax: /logdays-[number of days]
  359.        Sample: /logdays-5
  360.  
  361.     /user
  362.     Use this switch to set  the NetWare user ID for accessing  remote file 
  363.     servers. When the WP Office 3.1 or GroupWise 4.x systems reside in 
  364.     different file servers, you must create identical user accounts of each
  365.     server to give the NLM  access.  Each account must have identical 
  366.     mappings, rights, and password.
  367.  
  368.        Syntax: /user-[user ID]
  369.        Sample: /user-bob
  370.  
  371.     /password
  372.     Use this switch to set the password for accessing remote file servers.
  373.     See /user for more information.
  374.  
  375.        Syntax: /password-[password]
  376.        Sample: /password-mfc
  377.  
  378.     /help
  379.     Use this switch to display the online startup switch help screen. 
  380.     This will not load a functioning NLM.
  381.  
  382.  
  383.  
  384. THE STARTUP FILE
  385.  
  386. The startup file is a text file that stores all the switches used by the NLM.
  387. If you use the startup file, you do not have to type each switch and its 
  388. value at the system console when you load the NLM. An example of the default 
  389. startup file is found below.
  390.  
  391. ; Sample NGWMFC startup file
  392. ; ===========================
  393.  
  394. ; Use this file to store switch settings for the MFC NLM. Remove
  395. ; the semicolon from the line below the word EXAMPLE, and replace
  396. ; the sample settings with your network settings.
  397.  
  398. ;THE FOLLOWING SWITCHES ARE REQUIRED. 
  399.  
  400. ; HOME points the NLM to the path of the gateway directory 
  401. ; Syntax: /HOME=[server/volume]:path
  402. ; Example: see below
  403.  
  404. ; /home=server1/vol1:\domain1\wpgate\mfcgw
  405.  
  406.  
  407. ; 31TRANSIN points the NLM to the path of the 3.1 \TRANSIN
  408. ; directory.  You must include \TRANSIN at the end of the path.
  409. ; Syntax: /31TRANSIN=[server/volume]:path
  410. ; Example: see below
  411.  
  412. ; /31transin=server1/vol1:\31domain\host6\transin
  413.  
  414. ; =============================================================
  415.  
  416. ;THE FOLLOWING SWITCHES ARE OPTIONAL. 
  417.  
  418. ; 31PULL points to the path of the 3.1 pull directory instead of
  419. ; using the MFCGW\TRANSIN. Required for VAX hosts.
  420. ; Syntax: /31PULL=[server/volume]:path
  421. ; Example: see below
  422.  
  423. ; /31pull=server1/vol1:\31domain\to_pc\transin
  424.  
  425.  
  426. ; LOGPATH points to the path of the log file directory.
  427. ; Default:\mfcgw\LOG\
  428. ; Syntax:/LOGPATH=[server/volume]:path
  429. ; Example: see below
  430.  
  431. ; /logpath=server1/vol1:\nlmlogs\mfcgw
  432.  
  433.  
  434. ; USER is a NetWare user ID. Required if connecting to other
  435. ; servers. User ID must be common for all connected servers.
  436. ; Syntax: /USER=NetWare User ID
  437. ; Example: see below.
  438.  
  439. ;/user=mfcuser
  440.  
  441.  
  442. ; PASSWORD is the NetWare password of the user ID of the /USER
  443. ; switch. Required if /USER is used.
  444. ; Syntax: /PASSWORD=NetWare password
  445. ; Example: see below
  446.  
  447. ; /password=resucfm
  448.  
  449.  
  450. ; SCANCYCLE specifies how often the NLM scans for messages.
  451. ; Default: 60 seconds
  452. ; Syntax: /SCANCYCLE=number of seconds
  453. ; Example: see below
  454.  
  455. ; /scancycle=300
  456.  
  457.  
  458. ; LOGLEVEL specifies the level of details for screen and disk
  459. ; logging. Levels include: Off, Normal, Verbose, and Diagnostic.
  460. ; Default: Normal
  461. ; Syntax: /LOGLEVEL=level
  462. ; Example: see below
  463.  
  464. ; /loglevel=verbose
  465.  
  466.  
  467. ; LOGDISKOFF turns off disk logging. Screen logging is controlled
  468. ; by /LOGELEVEL.
  469. ; Default: ON
  470. ; Syntax: see below
  471.  
  472. ; /LOGDISKOFF
  473.  
  474.  
  475. ; LOGMAX Specifies maximum disk space allowed for log files.
  476. ; Default: 1024 kilobytes
  477. ; /LOGMAX=number of kilobytes of space
  478. ; Example: see below
  479.  
  480. ; /logmax=2048
  481.  
  482.  
  483. ; LOGDAYS specifies the number of days log files are stored.
  484. ; Default: 7
  485. ; Syntax: /LOGDAYS=number of days
  486. ; Example: see below
  487.  
  488. ; /logdays=21
  489.  
  490. ; end of file.............
  491. =================================================================
  492.              
  493.  
  494. Before you use the startup file, edit the switch values to reflect your 
  495. network's configuration. Use a semicolon to disable a switch or to add 
  496. comments.
  497.  
  498.  
  499. MANUALLY LOADING AT THE NETWARE CONSOLE
  500.  
  501. To load the MFC NLM from the console prompt, NetWare must first know where
  502. the NLM resides. By default, NetWare looks to the SYS:SYSTEM directory for 
  503. all NLMs. If the NLM is not found there, NetWare checks all search paths. 
  504. You may also choose to include the full pathname where the MFC NLM resides.
  505. This points NetWare directly to the proper location.
  506.  
  507. Syntax:  load [server/volume:]ngwmfc /home-[path] /31transin-[path]
  508. Sample:  load server1/vol1:mfc\ngwmfc /home-server1/vol1:headq\wpgate\mfc
  509.          /31transin-server1/vol1:office31\host
  510.  
  511.  
  512. MANUALLY LOADING WITH A STARTUP FILE
  513.  
  514. To load the MFC NLM using a Startup file, you must know the location of 
  515. the MFC NLM and the startup file. You must also have edited the startup 
  516. file to fit your network environment.
  517.  
  518. Syntax:  load [server/volume:]ngwmfc @[volume/server:]path\startup file              
  519.                                          
  520. Sample:  load server1/vol1:mfc\ngwmfc @\system\mfc\startup.mfc
  521.  
  522.  
  523. AUTOMATICALLY LOADING USING AUTOEXEC.NCF
  524.  
  525. You can add the loading syntax to AUTOEXEC.NCF so that the MFC NLM loads 
  526. automatically each time you bring up the file server. You can enter the 
  527. complete load command without the startup file, or you can use the 
  528. startup file.  Remember that you must down the file server and bring it 
  529. back up before AUTOEXEC.NCF loads the NLM. Make sure you test the loading
  530. syntax at the console prompt before you add it to AUTOEXEC.NCF.
  531.  
  532.  
  533.  
  534. THE MFC OPERATION SCREEN
  535.  
  536. When the MFC NLM has been successfully loaded, the MFC Operation
  537. screen appears. The MFC Operation screen is divided into the
  538. following sections:
  539.  
  540.     ■  Information/Statistics
  541.     ■  Logging
  542.     ■  Interface menu
  543.  
  544.     INFORMATION/STATISTICS
  545.     This section displays the name and description assigned to the MFC NLM 
  546.     through the Admin program and the name of the GroupWise 4.x domain it 
  547.     is servicing. 
  548.  
  549.        UPTIME: This field displays the length of time the NLM has
  550.        been running.
  551.  
  552.        PROCESSING: This field displays a rotating bar used to indicate 
  553.        that the NLM is currently running.
  554.  
  555.        INCOMING PROCESS: This field indicates the MFC NLM's processing 
  556.        state for incoming WP Office 3.1 messages. It toggles between 
  557.        ACTIVE and CLOSED.
  558.  
  559.        OUTGOING PROCESS: This field indicates the MFC NLM's processing 
  560.        state for outgoing GroupWise 4.x messages. It toggles between 
  561.        ACTIVE and CLOSED.
  562.  
  563.        INCOMING MESSAGES: This field displays the number of messages that
  564.        have arrived from the WP Office 3.1 system.
  565.  
  566.        OUTGOING MESSAGES: This field displays the number of messages that 
  567.        have been sent to the WP Office 3.1 system.
  568.  
  569.     LOGGING
  570.     This section displays the tasks performed by the NLM. The amount of 
  571.     detail displayed here is determined by the logging level. The default
  572.     logging level is set using Admin. You can override the default 
  573.     setting by using the /loglevel switch or by using the Options menu. 
  574.     See INTERFACE MENU for more information.
  575.  
  576.     The data displayed on the screen is also written to the log file.
  577.  
  578.     INTERFACE MENU
  579.     The interface menu is found on the bottom line of the MFC Operation 
  580.     Screen. The options are:
  581.  
  582.        F7-EXIT: Press F7 to unload the NLM. When the NLM is unloaded, 
  583.        messages will no longer be converted.
  584.  
  585.        F9-BROWSE LOG FILES: Press F9 to display the current log file in 
  586.        a NetWare viewing window. You can scroll this window from top to 
  587.        bottom.
  588.  
  589.        F10- OPTIONS: Press F10 to display the Options Menu which provides 
  590.        the following options:
  591.  
  592.          VIEW LOG FILE: This option displays a list of all log files that 
  593.          reside on the disk. You can view any file that is displayed.
  594.  
  595.          CONFIGURE: This option lets you change the defaults that were 
  596.          set using Admin or the startup switches. These changes take 
  597.          effect immediately; they remain active until you change them 
  598.          again or until you unload the NLM. The following settings can 
  599.          be changed:
  600.  
  601.             LOG LEVEL: Use this option to change the logging level.
  602.  
  603.             MAX LOG AGE: Use this option to change the length of time 
  604.             the log files are stored on the disk.
  605.  
  606.             MAX DISK SPACE: Use this option to control how much space 
  607.             the log files can use until the older ones are deleted.
  608.  
  609.          EDIT STARTUP FILE: This option displays only if you loaded the 
  610.          NLM using a startup file. It lets you change the switch settings.
  611.          These changes will take effect after you unload the NLM and load 
  612.          it using the edited startup file.